home *** CD-ROM | disk | FTP | other *** search
/ Aminet 37 / Aminet 37 (2000)(Schatztruhe)[!][Jun 2000].iso / Aminet / util / misc / StripHunks.readme < prev    next >
Text File  |  2000-05-02  |  4KB  |  80 lines
  1. Short:    V1.9 CLI tool to strip useless hunks
  2. Author:   stoecker@amigaworld.com (Dirk Stoecker)
  3. Uploader: stoecker@amigaworld.com (Dirk Stoecker)
  4. Version:  1.9
  5. Type:     util/misc
  6.  
  7. This program removes most time useless parts of executable files:
  8.   - HUNK_DEBUG hunks
  9.   - HUNK_SYMBL hunks
  10.   - HUNK_NAME hunks
  11.   - empty HUNK_RELOC32, HUNK_DREL32 and HUNK_RELOC32SHORT
  12.   - empty DATA/CODE/BSS hunks, when it is the last hunk
  13.  
  14. When there are empty hunks at other places than the last one, you get a
  15. short information.
  16.  
  17. Use it with care! Sometimes the files will not work after stripping these
  18. hunks, so test it.
  19.  
  20. SYNOPSIS:  StripHunks FILES/M,ONLYSHOW/S,ALL/S,SORT=SORTRELOC/S,NOSTRIP/S,
  21.                       NSE=NOSTRIPEMPTY/S,NSN=NOSTRIPNAME/S,
  22.                       NSD=NOSTRIPDEBUG/S,NSS=NOSTRIPSYMBOL/S,
  23.                       NSR=NOSTRIPRELOC/S,SBW=SORTBACKWARDS/S,
  24.                       NSO=NOSORTONLY/S:
  25.  
  26. FILES:      The file/files which should be processed. Wildcards are supported.
  27. ONLYSHOW: The program does not save the stripped files back to disk.
  28. ALL:      Scan sub directories as well.
  29. SORT:     Sorts relocation entries from lower to higher values. This may
  30.           save space on older programs, as they sometimes have splitted
  31.           relocation entries.
  32. NOSTRIP:  Disables all stripping.
  33. NSE:      EMPTY hunks are not stripped.
  34. NSN:      NAME hunks are not stripped.
  35. NSD:      DEBUG hunks are not stripped.
  36. NSS:      SYMBOL hunks are not stripped.
  37. NSR:      RELOC information is not stripped.
  38. SBW:      With SORT keyword reloc is sorted from highest to lowest number.
  39. NSO:      Does ignore SORT option for files, which get not shorter.
  40.  
  41. Files with unknown structure show a warning and are not processed. Non
  42. executable files are ignored.
  43.  
  44. NOTE: It may destroy files to strip EMPTY, DEBUG or SYMBOL hunks, but it
  45. should work for lot of files. I do not know files, where stripping NAME
  46. hunks or relocation information caused errors.
  47. Sorting the relocation entries should not produce any problems as well,
  48. but it is useful to compare two files byte for byte, as some crunchers
  49. sort relocation information as well.
  50.  
  51. Please report me bugs, comments, suggestions and problems. If possible
  52. write a little mail if you use the program sometimes. If there are some
  53. Enforcer hits or other problems report them as good as possible.
  54.  
  55. Use it as you want, but WITHOUT ANY WARRANTY!
  56.  
  57. Please contact me:
  58.  
  59. ************************************************************************
  60. * snail-mail:                  * e-mail:                               *
  61. *   Dirk Stoecker              *   stoecker@amigaworld.com             *
  62. *   Geschwister-Scholl-Str. 10 *   dstoecker@gmx.de                    *
  63. *   01877 Bischofswerda        * world wide web:                       *
  64. *   GERMANY                    *   http://home.pages.de/~stoecker/     *
  65. * phone:                       * pgp key:                              *
  66. *   GERMANY +49 (0)3594/706666 *   get with finger or from WWW pages   *
  67. ************************************************************************
  68.  
  69.  
  70. ============================= Archive contents =============================
  71.  
  72. Original  Packed Ratio    Date     Time    Name
  73. -------- ------- ----- --------- --------  -------------
  74.     3567    1568 56.0% 01-Apr-00 12:47:34 +SDI_defines.h
  75.    16395    4058 75.2% 01-Apr-00 12:47:34 +StripHunks.c
  76.     4064    2453 39.6% 01-Apr-00 12:47:34  StripHunks
  77.     3060    1310 57.1% 01-Apr-00 12:47:34  StripHunks.readme
  78. -------- ------- ----- --------- --------
  79.    27086    9389 65.3% 02-Apr-100 14:41:18   4 files
  80.